package com.ruoyi.service;

import java.util.List;
import com.ruoyi.domain.MobileUserCoupon;

/**
 * 用户优惠券Service接口
 * 
 * @author ruoyi
 * @date 2025-01-20
 */
public interface IMobileUserCouponService 
{
    /**
     * 查询用户优惠券
     * 
     * @param id 用户优惠券主键
     * @return 用户优惠券
     */
    public MobileUserCoupon selectMobileUserCouponById(Integer id);

    /**
     * 查询用户优惠券列表
     * 
     * @param mobileUserCoupon 用户优惠券
     * @return 用户优惠券集合
     */
    public List<MobileUserCoupon> selectMobileUserCouponList(MobileUserCoupon mobileUserCoupon);

    /**
     * 根据用户ID查询优惠券列表（包含优惠券详细信息）
     * 
     * @param userId 用户ID
     * @return 用户优惠券集合
     */
    public List<MobileUserCoupon> selectUserCouponsWithDetails(Integer userId);

    /**
     * 根据用户ID查询可用优惠券列表
     * 
     * @param userId 用户ID
     * @return 可用优惠券集合
     */
    public List<MobileUserCoupon> selectAvailableUserCoupons(Integer userId);

    /**
     * 根据用户ID和商家ID查询可用优惠券列表（用于订单页面选择优惠券）
     * 
     * @param userId 用户ID
     * @param merchantId 商家ID
     * @return 可用优惠券集合
     */
    public List<MobileUserCoupon> selectAvailableUserCouponsByMerchant(Integer userId, Integer merchantId);

    /**
     * 领取优惠券
     * 
     * @param userId 用户ID
     * @param couponId 优惠券ID
     * @return 结果
     */
    public int receiveCoupon(Integer userId, Integer couponId);

    /**
     * 使用优惠券
     * 
     * @param userCouponId 用户优惠券ID
     * @param orderId 订单ID
     * @return 结果
     */
    public int useCoupon(Integer userCouponId, Long orderId);

    /**
     * 新增用户优惠券
     * 
     * @param mobileUserCoupon 用户优惠券
     * @return 结果
     */
    public int insertMobileUserCoupon(MobileUserCoupon mobileUserCoupon);

    /**
     * 修改用户优惠券
     * 
     * @param mobileUserCoupon 用户优惠券
     * @return 结果
     */
    public int updateMobileUserCoupon(MobileUserCoupon mobileUserCoupon);

    /**
     * 删除用户优惠券信息
     * 
     * @param id 用户优惠券主键
     * @return 结果
     */
    public int deleteMobileUserCouponById(Integer id);
}
